31.10.2 Displaying the Diary

Once you have created a diary file, you can use the calendar to view it. You can also view today’s events outside of Calendar mode. In the following, key bindings refer to the Calendar buffer.

mouse-3 Diary

d

Display all diary entries for the selected date (diary-view-entries).

s

Display the entire diary file (diary-show-all-entries).

m

Mark all visible dates that have diary entries (diary-mark-entries).

u

Unmark the calendar window (calendar-unmark).

M-x diary-print-entries

Print hard copy of the diary display as it appears.

M-x diary

Display all diary entries for today’s date.

M-x diary-mail-entries

Mail yourself email reminders about upcoming diary entries.

Displaying the diary entries with d shows in a separate buffer the diary entries for the selected date in the calendar. The mode line of the new buffer shows the date of the diary entries. Holidays are shown either in the buffer or in the mode line, depending on the display method you choose (see Diary Display). If you specify a numeric argument with d, it shows all the diary entries for that many successive days. Thus, 2 d displays all the entries for the selected date and for the following day.

Another way to display the diary entries for a date is to click mouse-3 on the date, and then choose Diary entries from the menu that appears. If the variable calendar-view-diary-initially-flag is non-nil, creating the calendar lists the diary entries for the current date (provided the current date is visible).

To get a broader view of which days are mentioned in the diary, use the m command. This marks the dates that have diary entries in a different face. See diary-entry-marker.

This command applies both to the months that are currently visible and to those that subsequently become visible after scrolling. To turn marking off and erase the current marks, type u, which also turns off holiday marks (see Holidays). If the variable calendar-mark-diary-entries-flag is non-nil, creating or updating the calendar marks diary dates automatically.

To prevent an individual diary entry from being marked in the calendar, insert the string that diary-nonmarking-symbol specifies (the default is ‘&’) at the beginning of the entry, before the date. This has no effect on display of the entry in the diary buffer; it only affects marks on dates in the calendar. Nonmarking entries can be useful for generic entries that would otherwise mark many different dates.

To see the full diary file, rather than just some of the entries, use the s command.

The command M-x diary displays the diary entries for the current date, independently of the calendar display, and optionally for the next few days as well; the variable diary-number-of-entries specifies how many days to include. See diary-number-of-entries.

If you put (diary) in your .emacs file, this automatically displays a window with the day’s diary entries when you start Emacs.

Some people like to receive email notifications of events in their diary. To send such mail to yourself, use the command M-x diary-mail-entries. A prefix argument specifies how many days (starting with today) to check; otherwise, the variable diary-mail-days says how many days.